<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html><!-- InstanceBegin template="/Templates/Function Info.dwt" codeOutsideHTMLIsLocked="false" -->
<head>
<!-- InstanceBeginEditable name="doctitle" -->
<title>WinXAddRadioButton</title>
<!-- InstanceEndEditable -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

<!-- InstanceBeginEditable name="head" --><!-- InstanceEndEditable -->
<style type="text/css">
<!--
.style3 {font-size: medium}
-->
</style>

<link href="../../WinXStyles.css" rel="stylesheet" type="text/css">
<style type="text/css">
<!--
.style1 {
	font-size: x-large;
	font-family: Verdana, Arial, Helvetica, sans-serif;
}
.style2 {
	font-size: large;
	font-family: Verdana, Arial, Helvetica, sans-serif;
}
-->
</style>
</head>

<body>
<h1 class="style1"><img src="../../WinX48.png" width="48" height="48" align="absmiddle"> <!-- InstanceBeginEditable name="title" -->WinXAddRadioButton<!-- InstanceEndEditable --></h1>
<hr>

<!-- InstanceBeginEditable name="Prototype" -->
<p>hRadio = WinXAddRadioButton (parent, STRING title, isFirst, pushlike, id)</p>
<!-- InstanceEndEditable --><!-- InstanceBeginEditable name="Description" -->
<p>Creates a radio button and adds it to a window </p>
<!-- InstanceEndEditable -->
<table width="80%" border="1" cellpadding="0" cellspacing="0">
  <tr bgcolor="#CCCCCC">
    <th width="24%"><span class="style3">Parameter</span></th>
    <th width="76%"><span class="style3">Description</span></th>
  </tr>
  <!-- InstanceBeginRepeat name="Parameter Table" --><!-- InstanceBeginRepeatEntry -->
  <tr bgcolor="#E8E8E8">
    <td><!-- InstanceBeginEditable name="Parameter" -->parent<!-- InstanceEndEditable --></td>
    <td><!-- InstanceBeginEditable name="Description" -->The window to add the radio button to <!-- InstanceEndEditable --></td>
  </tr>
  <!-- InstanceEndRepeatEntry --><!-- InstanceBeginRepeatEntry -->
  <tr bgcolor="#E8E8E8">
    <td><!-- InstanceBeginEditable name="Parameter" -->STRING title <!-- InstanceEndEditable --></td>
    <td><!-- InstanceBeginEditable name="Description" -->The text to appear to the right of the radio button<!-- InstanceEndEditable --></td>
  </tr>
  <!-- InstanceEndRepeatEntry --><!-- InstanceBeginRepeatEntry -->
  <tr bgcolor="#E8E8E8">
    <td><!-- InstanceBeginEditable name="Parameter" -->isFirst<!-- InstanceEndEditable --></td>
    <td><!-- InstanceBeginEditable name="Description" -->$$TRUE if this is the first radio button in a group <!-- InstanceEndEditable --></td>
  </tr>
  <!-- InstanceEndRepeatEntry --><!-- InstanceBeginRepeatEntry -->
  <tr bgcolor="#E8E8E8">
    <td><!-- InstanceBeginEditable name="Parameter" -->pushlike<!-- InstanceEndEditable --></td>
    <td><!-- InstanceBeginEditable name="Description" -->$$TRUE to render this radio button as a pushbutton <!-- InstanceEndEditable --></td>
  </tr>
  <!-- InstanceEndRepeatEntry --><!-- InstanceBeginRepeatEntry -->
  <tr bgcolor="#E8E8E8">
    <td><!-- InstanceBeginEditable name="Parameter" -->id<!-- InstanceEndEditable --></td>
    <td><!-- InstanceBeginEditable name="Description" -->the unique id constant for this control <!-- InstanceEndEditable --></td>
  </tr>
  <!-- InstanceEndRepeatEntry --><!-- InstanceEndRepeat -->
</table>
<h3>Returns</h3>
<!-- InstanceBeginEditable name="Return Info" -->
<p>The handle to the radio button or 0 on fail </p>
<!-- InstanceEndEditable -->
<h3>Remarks</h3>
<!-- InstanceBeginEditable name="Remarks" -->
<p>The isFirst parameter is used to define groups of radio buttons. The radio buttons within a group are mutually exclusive. That is, only one can be selected at any one time. The user can move between radio buttons within a group if the <a href="../General.htm/WinXEnableDialogInterface.htm">dialog interface</a> is enabled. To group your radio buttons, set the isFirst parameter to $$TRUE for the first radio button in the group and $$FALSE for all subsequent radio buttons. </p>
<p>If pushlike is $$TRUE, this function will create a pushbutton which can be toggled from pressed to unpressed, corresponding to the checked and unchecked states of a radio box. </p>
<!-- InstanceEndEditable -->
<h3>Examples</h3>
<table width="80%"  border="0">
  <tr>
    <td bgcolor="#C6C6FF"><!-- InstanceBeginEditable name="Example Code" -->
      <p class="codeStyle">'define constants<br>
  $$ID_RADIO1 = 100 <br>
  $$ID_RADIO2 = 101 <br>
  $$ID_RADIO3 = 102 </p>
      <p class="codeStyle"> 'create a set of check boxes <br>
  hCheck1 = WinXAddRadioButton (#hMain, &quot;Item 1&quot;, $$TRUE, $$FALSE, $$ID_RADIO1)<br>
  hCheck2 = WinXAddRadioButton (#hMain, &quot;Item 2&quot;, $$FALSE, $$FALSE, $$ID_RADIO2)<br>
  hCheck3 = WinXAddRadioButton (#hMain, &quot;Item 3&quot;, $$FALSE, $$FALSE, $$ID_RADIO3)</p>
    <!-- InstanceEndEditable --></td>
  </tr>
</table>

<h2 class="style2">Related Links</h2>
<!-- InstanceBeginEditable name="Related Links" -->
<p><a href="WinXButton_SetCheck.htm">WinXButton_SetCheck</a><br>
  <a href="WinXButton_GetCheck.htm">WinXButton_GetCheck</a><br>
  <a href="../General.htm/WinXEnableDialogInterface.htm">WinXEnableDialogInterface</a></p>
<!-- InstanceEndEditable -->
</body>
<!-- InstanceEnd --></html>
